<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>音频流</title>

 </head>
 <body><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="wrappers.rar.html">rar://</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="wrappers.expect.html">expect://</a></div>
 <div class="up"><a href="wrappers.html">支持的协议和封装协议</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="wrappers.audio" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">ogg://</h1>
  <p class="refpurpose"><span class="refname">ogg://</span> &mdash; <span class="dc-title">音频流</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-wrappers.audio-description">
  <h3 class="title">说明</h3>
  <p class="para">
   通过包装器 <var class="filename">ogg://</var> 读取的文件，
   是作为 <em>OGG/Vorbis</em> 格式的压缩音频编码。
   同样，通过包装器 <var class="filename">ogg://</var> 写入或追加的数据格式也是压缩音频。
   
   当 <span class="function"><a href="function.stream-get-meta-data.html" class="function">stream_get_meta_data()</a></span> 用于一个打开读取的 <em>OGG/Vorbis</em>
   文件时，会返回关于数据流的详细信息，包含了 <em><code class="parameter">vendor</code></em> 标签、任何内含的
   <em><code class="parameter">comments</code></em>、
   <em><code class="parameter">channels</code></em> 数字、采样率（<em><code class="parameter">rate</code></em>），以及
   用 <em><code class="parameter">bitrate_lower</code></em>、<em><code class="parameter">bitrate_upper</code></em>、
   <em><code class="parameter">bitrate_nominal</code></em> 和 <em><code class="parameter">bitrate_window</code></em>
   描述的可变比特率范围。
  </p>

  <p class="simpara"><var class="filename">ogg://</var> PHP 4.3.0 及以上（PECL） </p>
  <blockquote class="note"><p><strong class="note">Note</strong>: 
   <strong>该封装器默认未激活</strong><br />
   <span class="simpara">
    要使用 <var class="filename">ogg://</var> 封装器，您必须安装
     <a href="http://pecl.php.net/package/oggvorbis" class="link external">&raquo;&nbsp;OGG/Vorbis</a> 扩展。
    可以在 <a href="http://pecl.php.net/" class="link external">&raquo;&nbsp;PECL</a> 上找到。
   </span>
  </p></blockquote>
 </div>


 <div class="refsect1 usage" id="refsect1-wrappers.audio-usage"> 
  <h3 class="title">可选项</h3>
  <ul class="itemizedlist">
   <li class="listitem"><span class="simpara"><var class="filename">ogg://soundfile.ogg</var></span></li>
   <li class="listitem"><span class="simpara"><var class="filename">ogg:///path/to/soundfile.ogg</var></span></li>
   <li class="listitem"><span class="simpara"><var class="filename">ogg://http://www.example.com/path/to/soundstream.ogg</var></span></li>
  </ul>
 </div>
 

 <div class="refsect1 options" id="refsect1-wrappers.audio-options">
  <h3 class="title">可选项</h3>
  <p class="para">
   <table class="doctable table">
    <caption><strong>封装协议摘要</strong></caption>
    
     <thead>
      <tr>
       <th>属性</th>
       <th>支持</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td>受限于 <a href="filesystem.configuration.html#ini.allow-url-fopen" class="link">allow_url_fopen</a></td>
       <td>No</td>
      </tr>

      <tr>
       <td>允许读取</td>
       <td>Yes</td>
      </tr>

      <tr>
       <td>允许写入</td>
       <td>Yes</td>
      </tr>

      <tr>
       <td>允许附加</td>
       <td>Yes</td>
      </tr>

      <tr>
       <td>允许同时读写</td>
       <td>No</td>
      </tr>

      <tr>
       <td>支持 <span class="function"><a href="function.stat.html" class="function">stat()</a></span></td>
       <td>No</td>
      </tr>

      <tr>
       <td>支持 <span class="function"><a href="function.unlink.html" class="function">unlink()</a></span></td>
       <td>No</td>
      </tr>

      <tr>
       <td>支持 <span class="function"><a href="function.rename.html" class="function">rename()</a></span></td>
       <td>No</td>
      </tr>

      <tr>
       <td>支持 <span class="function"><a href="function.mkdir.html" class="function">mkdir()</a></span></td>
       <td>No</td>
      </tr>

      <tr>
       <td>支持 <span class="function"><a href="function.rmdir.html" class="function">rmdir()</a></span></td>
       <td>No</td>
      </tr>

     </tbody>
    
   </table>

  </p>
  
  <p class="para">
   <table class="doctable table">
    <caption><strong>上下文选项</strong></caption>
    
     <thead>
      <tr>
       <th>Name</th>
       <th>Usage</th>
       <th>Default</th>
       <th>Mode</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td><em>pcm_mode</em></td>
       <td>
        读取时使用如下 PCM 编码之一: 
        <strong><code>OGGVORBIS_PCM_U8</code></strong>、<strong><code>OGGVORBIS_PCM_S8</code></strong>、
        <strong><code>OGGVORBIS_PCM_U16_BE</code></strong>、<strong><code>OGGVORBIS_PCM_S16_BE</code></strong>、
        <strong><code>OGGVORBIS_PCM_U16_LE</code></strong> 和 <strong><code>OGGVORBIS_PCM_S16_LE</code></strong>。
        (8 或 16 位，签名或未签名，大或小的 <em>endian</em>)
       </td>
       <td>OGGVORBIS_PCM_S16_LE</td>
       <td>读取</td>
      </tr>

      <tr>
       <td><em>rate</em></td>
       <td>
        输入数据的采样率，单位为 Hz
       </td>
       <td>44100</td>
       <td>写入/附加</td>
      </tr>

      <tr>
       <td><em>bitrate</em></td>
       <td>
        若给的值为整数，则是用固定的比特率进行编码。（16000 到 131072）若给的值为浮点数，则使用可变的比特率（质。(-1.0 到 1.0）
       </td>
       <td>128000</td>
       <td>写入/附加</td>
      </tr>

      <tr>
       <td><em>channels</em></td>
       <td>
        要编码的声道的数量，典型为 1 (单声道), 或 2 (立体声)。最高支持 16 声道。
       </td>
       <td>2</td>
       <td>写入/附加</td>
      </tr>

      <tr>
       <td><em>comments</em></td>
       <td>
        编码到音轨头部的字符串数组。
       </td>
       <td class="empty">&nbsp;</td>
       <td>写入/附加</td>
      </tr>

     </tbody>
    
   </table>

  </p>
 </div>
 

 <div class="refsect1 examples" id="refsect1-wrappers.audio-examples">
  <h3 class="title">范例</h3>
 </div>


</div><hr /><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="wrappers.rar.html">rar://</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="wrappers.expect.html">expect://</a></div>
 <div class="up"><a href="wrappers.html">支持的协议和封装协议</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
